```
O papel da função `str_replace` no PHP é substituir todas as ocorrências de uma string por outra string dentro de uma string original. Essa função é amplamente utilizada para manipulação de strings, permitindo a modificação de partes específicas do texto de forma eficiente.
- Sintaxe
```php
str_replace(mixed $search, mixed $replace, mixed $subject, int &$count = null): mixed
```
- Parâmetros
1. search: O valor a ser buscado. Pode ser uma string ou um array de strings a serem procuradas.
2. replace: O valor de substituição. Pode ser uma string ou um array de strings que irão substituir os valores encontrados.
3. subject: A string ou array de strings em que a pesquisa e substituição serão realizadas.
4. count (opcional): Se especificado, será preenchido com o número de substituições realizadas.
- Exemplos Usuais de Uso
- Substituição Simples
```
$originalString = “Olá, mundo!”;
$novaString = str_replace(“mundo”, “PHP”, $originalString);
echo $novaString; // Saída: “Olá, PHP!”
```
Neste exemplo, a função `str_replace` busca a palavra “mundo” na string original e a substitui por “PHP”.
- Substituição com Arrays
```
$frase = “Eu gosto de maçã, banana e cereja.”;
$frutas = [“maçã”, “banana”, “cereja”];
$nomeFrutas = [“laranja”, “uva”, “kiwi”];
$novaFrase = str_replace($frutas, $nomeFrutas, $frase);
echo $novaFrase; // Saída: “Eu gosto de laranja, uva e kiwi.”
```
Neste caso, a função `str_replace` é usada com arrays tanto no parâmetro de busca quanto no de substituição, permitindo a modificação de múltiplas palavras em uma única chamada de função.
- Contando Substituições
```
$texto = “isso isso é um teste.”;
$contagem = 0;
$novoTexto = str_replace(“isso”, “aquilo”, $texto, $contagem);
echo $novoTexto; // Saída: “aquilo aquilo é um teste.”
echo $contagem; // Saída: 2
```
Aqui, o quarto parâmetro é usado para contar quantas substituições foram feitas, resultando no valor 2.
- Fontes de Referência
- Documentação Oficial do PHP: A documentação da função `str_replace` no site oficial do PHP é uma referência primária e confiável para entender a funcionalidade e os casos de uso dessa função. [PHP: str_replace – Manual](https://www.php.net/manual/pt_BR/function.str-replace.php)
- W3Schools: Um recurso suplementar que fornece exemplos práticos sobre o uso de `str_replace` e outras funções relacionadas a strings no PHP. [W3Schools PHP str_replace](https://www.w3schools.com/php/func_string_str_replace.asp)
- Conclusão
A função `str_replace` é uma ferramenta poderosa e flexível no PHP para a substituição de texto dentro de strings. Sua capacidade de trabalhar com tanto strings simples quanto arrays de strings torna-a indispensável em tarefas de manipulação textual. É essencial entender seu funcionamento e como utilizá-la eficientemente para otimizar as operações de manipulação de dados em projetos PHP.
\`\`\`
